Moving  RAMTQP  in  Timex/Sinclair  1000  Computers 


by  Anthony  J.  Oresteen  2  Feb  1985 

This  article  will  explain  how  to  change  the  amount  of  memory  you  have 
available  on  the  ZX-81  and  T/S  1000  computers.  More  importantly  it  will 
explain  how  to  use  32K  and  64k  RAM. pack. 

The  ZX-81  (I  will  only  refer  to  the  ZX-81  but  it  means  the  T/S  1000  as 
well)  computer  can  have  up  to  48k  RAM  added  that  is  loadable  and  saveable 
from  Basic.  Since  the  ZX-81  doesn't  know  how  much  memory  is  attached  it 
checks  to  see  how  much  memory  is  attached  everytime  the  power  is  turned 
on  and  the  system  self-boots.  Unfortunately  Sinclair  never  planned  for 
more  than  16K  RAM  of  memory  being  added  and  the  ZX-81  initialzation 
routine  in  the  ROM  does  not  check  any  memory  above  memory  location 
32767  (the  end  of  a  16k  RAM  pack).  With  a  64k  pack  attached  you  have 
memory  locations  up  to  65535  but  the  ZX-81  will  not  know  it  and  thinks 
that  the  memory  is  not  there. 

There  are  a  number  of  RAM  packs  availeable  for  the  ZX-81.  The  most 
common  sizes  are  16K,  32K  and  64K.  Since  the  RAM  area  of  the  ZX-81 
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starts  at  16384  and  the  highest  memory  location  available  Is  65535  the 
most  RAM  that  you  can  have  Is  65535-16383  bytes  or  49152  bytes  on  the 
ZX-81.  As  Ik  of  memory  Is  1024  bytes,  49152  Is  refered  to  as  48k.  Some 
"64k"  packs  provied  RAM  UPTO  the  64k  location  of  65535  and  thus  are 
called  M64K“  packs  but  actually  have  only  48K  RAM  while  others  provide 
64K  RAM  from  0  to  65535  and  allow  you  to  switch  in  areas  of  RAM  from  0 
to  16383.  Note  that  the  ROM  lies  in  the  0  to  8191  area  and  you  will  run 
into  problems  if  you  try  to  use  that  area.  The  area  of  8192  to  16382  can 
have  RAM  but  you  can  NOT  put  BASIC  programs  there  so  it's  generaly  used 
for  machine  code  routines  and  other  accesory  items.  The  Memotech  64K 
RAM  pack  is  the  unit  I  use  and  it  will  allow  you  to  switch  in  areas  below 
16384  if  you  need  them.  Some  32k  packs  will  let  you  add  an  additional 
16k  pack  to  get  a  full  48k  ram  up  to  65535  (the  Memotech  is  one  that  will 
do  this  with  no  problems). 

The  ZX-81  has  a  number  of  system  variables  that  keep  track  of  where 
everything  is  in  the  computer.  One  system  variable  is  called  RAMTOP.  It 
is  located  at  16388  and  16389.  RAMTOP  tells  the  computer  how  much 
memory  is  available.  The  computer  takes  the  number  stored  in  16389, 
multiplies  it  by  256  and  then  adds  it  the  number  in  16388.  This  tells  the 
computer  the  location  of  the  first  memory  location  that  is  not  there.  With 
a  16k  pack  attached  you  will  get  128  if  you  enter  PEEK  16389  and  0  for 


o 


PEEK  16386.  Thus  128  x  256  +  0  =  32768  for  RAMTOP.  By  putting  diferent 
numbers  in  16388  and  16389  with  the  POKE  command  the  computer  will 
know  how  much  memory  you  are  using  (not  quite  but  more  on  this  later). 

There  are  three  basic  reasons  that  you  would  want  to  change  RAMTOP: 

1.  To  lower  RAMTOP  to  provide  room  for  machine  code  routines 
that  can  not  be  overwritten  by  BASIC  programs. 

2.  To  lower  RAMTOP  to  speed  up  save  and  load  times. 

3.  To  raise  RAMTOP  to  make  more  memory  space  available  to 
the  computer. 

It  would  apear  that  all  you  would  have  to  do  is  to  POKE  in  new  numbers  in 
16388  and  16389  and  RAMTOP  is  changed.  Sadly  this  is  not  true.  The 
computer  will  not  fully  recognize  a  RAMTOP  change  unless  the  command 
NEW  is  executed  after  the  new  value  is  placed  in  RAMTOP.  The  drawback  is 
that  NEW  wipes  out  all  of  your  Basic  program  and  clears  the  variables 
area.  The  reason  for  this  is  that  the  machine  stack  and  it’s  pointer 
(ERR_SP  at  16386  &  16387)  are  still  in  the  old  area  of  memory  blocking 
expansion  of  the  program  and  variables  area  (see  page  128  of  the  Sinclair 
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manual  for  a  diagram).  NEW  will  move  these  items  to  just  below  the  new 
RAMTGP  value  and  the  memory  is  opened  up  (or  reduced  as  the  case  may  be) 
for  programing. 

Method  1  to  move  RAMTOP. 


The  general  format  for  method  1  is: 

POKE  1 6368,  L  (low  value  portion) 
POKE  16389,  H  (high  value  portion) 
NEW 


To  find  values  of  H  &  L  first  determine  where  you  want  RAMTOP  to  be. 
Let's  assume  that  you  are  using  a  32k  rampack  and  you  want  to  use  every 
bit  of  memory.  32k  ends  at  49151,  so  divide  49151  by  256.  This  gives 
191.99609.  Drop  the  decimal  and  you  have  the  value  of  H  or  191.  Now 
multiply  191  by  256  and  you  get  48896.  Subtrack  48896  from  49151  and 
you  will  get  225  or  L.  Now  you  can  enter  the  following: 

POKE  16368,  255 

POKE  16389,  191  { 52k  values) 

NEW 
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If  all  this  math  bothers  you,  just  enter  RAND  49151  in  the  imediate  mode. 
The  values  of  SEED  at  16434  &  16435  will  have  the  correct  values  for  L  & 
H.  The  way  that  you  could  use  this  approach  is: 


RAND  49151 

POKE  16388,  PEEK  16434 
POKE  16389,  PEEK  16435 
NEW 

For  a  64k  pack  the  values  of  L  &  H  are  255  and  255. 

Method  2  to  move  RAMTOP  . 

In  this  method  we  will  use  a  machine  code  routine  that  will  do  all  the 
moving  without  using  NEW.  Thus  we  can  execute  a  RAMTOP  moving  routine 
from  within  a  program,  without  losing  control  of  the  computer  (executing 
NEW  from  within  a  program  wipes  the  program  out  and  gives  the  K  cursor). 

You  can  use  this  program  as  a  start-up  progam.  For  now  assume  that  the 
ramtop  routine  is  in  line  10: 
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10  REM  00000000000000000 


20  RAND  USR  16514 
30  LOAD 
40  STOP 

50  SAVE  "RAMTGP" 
60  GOTO  20 


If  you  save  the  program  by  entering  GOTO  50  in  the  imediate  mode  the 
program  will  self-start  the  next  time  you  load  it.  It  will  load  the  next 
program  on  the  tape  automacticly,  and  the  proper  value  of  RAMTOP  will 
have  been  set  (provided  we  insert  the  machine  code  routine  in  line  10  after 
the  REM).  If  the  second  program  is  also  self  starting  then  for  all  practical 
purposes  you  will  have  loaded  only  one  program. 

The  machine  code  routine  will  do  the  following: 

a.  Set  new  RAMTOP  value 

b.  Move  the  machine  stack 

c.  Set  new  ERR_SP  value 

Using  1  is  the  machine  code  routine.  Listing  2  is  a  byte-by-byte  listing  in 
decimal.  Simply  enter  the  first  line  of  your  program  as  1  REM  with  40 
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zeros  following,  then  poke  in  each  value  starting  with  16514.  Then  enter 
lines  20  to  60  as  needed. 

Rand  USR  16514  tells  the  computer  to  goto  memory  location  16514  and 
start  executing  the  machine  code  instructions  untill  it  comes  to  a  number 
201  which  means  return.  Since  the  routine  started  from  Basic  it  will 
return  to  Basic  and  execute  the  next  basic  line.  A  feature  of  the  ZX-81 
operating  system  is  that  the  first  line  of  Basic  allways  starts  at  16509. 
By  making  the  first  line  a  REM  line  with  machine  code  instructions,  we 
will  always  have  the  first  machine  code  instruction  at  16514. 

To  change  the  machine  code  routine  to  32K  change  165—  to  xxx  and  1 65 — 
to  xxx. 

Method  3  to  move  RAMTQP  using  COMPUSA  Disk  Drive 

When  using  the  Compusa  Floppy  Disk  Interface  RAMTOP  moves  become  very 
important.  Many  frustrating  hours  can  pass  trying  to  load  a  16k  Sinclair 
program  that  has  a  lot  of  machince  code  onto  disk.  The  Compusa  DOS 
(version  .5)  copies  the  disk  directory  into  RAM.  To  ensure  that  these 
directories  are  never  written  over  by  the  Basic,  on  turning  on  the  power 
the  DOS  lowers  RAMTOP  by  1388  bytes  and  resets  all  pointers. 
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Unfortunately  the  Compusa  DOS  (CDOS)  doesn't  check  to  see  if  you  have 
more  than  16k  ram.  If  you  are  using  64k  ram  you  must  move  RAMTOP  as 
before,  move  the  disk  directory,  and  move  the  disk  directory  pointer.  Then 
the  CDOS  will  allow  you  to  operate  without  getting  lost. 

The  CDOS  directory  pointer  is  ALWAYS  located  at  the  byte  pointed  to  by 
RAMTOP  and  the  byte  following.  Wherever  these  two  bytes  point  to  the 
CDOS  will  look  for  the  disk  directory.  If  the  directory  is  not  there  the 
system  will  crash  and  you  will  have  to  power  down  and  then  start  over 
again.  In  a  16K  system  the  pointer  &  RAMTOP  are  as  follows: 


16388 

147 

Ramtop  points  to  31379 

16389 

128 

31379 

149 

DOS  pointer  points  to  31381 

31380 

128 

31381 

DOS  directory  starts  here 

the  following  locations  for  RAMTOP  when  using  64k  and  32k  packs: 

For  64k: 

16388,  147 

RAMTOP  at  64147 

16389,  250 

64147,  149 

Directory  at  64149 

64148,  250 

For  32k: 

16388,  147 

Ramtop  at  47763 
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16389,  186 


47763,  149  Directory  at  47765 
47764,  186 

These  locations  put  the  directories  at  the  top  of  memory  and  free  up  the 
most  RAM  for  programing.  While  you  could  poke  in  the  four  new  values, 
execute  NEW,  and  then  do  a  GET  DIRECTORY  DOS  command,  the  following 
program  will  do  it  in  machine  code  and  you  never  give  up  control  of  the 
computer.  Listing  4  is  the  machine  code  program.  Listing  5  is  a  decimal 
byte-by-byte  breakdown  that  you  can  poke  into  a  REM  statement.  Listing  6 
is  the  Basic  listing.  This  program  is  for  64k.  If  you  have  a  32k  pack  use 
listing  7  &  8  for  the  correct  values  and  change  line  20  in  the  Basic 
program  to  read:  IF  PEEK  1 6389<  1 86  then  GOTO  70. 

Listing  6  needs  some  explanation.  Start  up  the  system  and  ensure  that  the 
DOS  is  at  the  16k  setting.  Load  the  RAMTOP  routine.  Enter  in  the  imediate 
mode:  GOTO  50.  Line  50  makes  the  program  a  self-starting  DOS  program. 
Line  60  MUST  be  a  GOTO,  do  not  change  to  RUN.  For  some  unknown  reason 
using  RUN  in  a  selfstaring  DOS  programs  sends  the  computer  off  into 
never-  return  land.  GOTO  10  keeps  everything  in  control.  Line  30  looks  for 
a  menu  program  on  the  disk.  If  you  don’t  have  a  menu  then  the  DOS  will 
give  you  an  error  message  and  stop. 
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You  should  now  have  a  good  understanding  on  how  the  ZX-81  sets  RAMTOP 
and  how  you  can  change  it  to  suite  your  needs.  All  of  the  programs  are 
tested  and  do  work.  If  you  don't  want  to  enter  the  programs  youself,  a  tape 
copy  of  all  of  the  RAMTOP  programs  is  available  by  sending  $7  directly  to 
the  author.  Good  luck  and  happy  computing! 
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